How to install the Altinity ClickHouse | 您所在的位置:网站首页 › Install ClickHouse ClickHouse Docs › How to install the Altinity ClickHouse |
How to install the Altinity ClickHouse-Operator to your Kubernetes environment
How to install and verify the Altinity Kubernetes Operator
28 July 2023 · Read time 4 min Introduction - Altinity ClickHouse-OperatorThis page provides instructions to deploy the Altinity Kubernetes Operator to your Kubernetes environment. Prerequisites The following items are required: Kubernetes version 1.15.11 or later Kubernetes Install Tools - kubectl is required. The other tools listed on this page (kind, minikube, and kubeadm) are optional clickhouse-operator-install-bundle.yaml - this is the latest (master branch) of the Altinity ClickHouse deployment YAML fileFor Other Altinity deployment YAML file versions To find other versions of the deployment YAML file, visit the file in our GitHub repo and select another branch from the GitHub branch menu. Deployment InstructionsThis example shows how to deploy version 0.21.2 of clickhouse-operator-install-bundle.yaml from the Altinity GitHub repository. NOTE: Altinity recommends that you deploy a specific version, rather than using the latest clickhouse-operator YAML file from the master branch. Installation Commands To install a version 0.21.2 of the Altinity Kubernetes Operator to your existing Kubernetes environment, run the following command: kubectl apply -f https://github.com/Altinity/clickhouse-operator/raw/0.21.2/deploy/operator/clickhouse-operator-install-bundle.yamlThe URL will be different if you’re using another version of the file. Alternatively, to deploy your own version of the YAML file, download and modify the latest Altinity Kubernetes Operator YAML file and run the following command: kubectl apply -f clickhouse-operator-install-bundle.yamlSuccessful Installation The following example response shows the result of a successful installation. customresourcedefinition.apiextensions.k8s.io/clickhouseinstallations.clickhouse.altinity.com created customresourcedefinition.apiextensions.k8s.io/clickhouseinstallationtemplates.clickhouse.altinity.com created customresourcedefinition.apiextensions.k8s.io/clickhouseoperatorconfigurations.clickhouse.altinity.com created serviceaccount/clickhouse-operator created clusterrole.rbac.authorization.k8s.io/clickhouse-operator-kube-system created clusterrolebinding.rbac.authorization.k8s.io/clickhouse-operator-kube-system created configmap/etc-clickhouse-operator-files created configmap/etc-clickhouse-operator-confd-files created configmap/etc-clickhouse-operator-configd-files created configmap/etc-clickhouse-operator-templatesd-files created configmap/etc-clickhouse-operator-usersd-files created deployment.apps/clickhouse-operator created service/clickhouse-operator-metrics createdInstallation Verification To verify that the installation was successful, run the following command: kubectl get deployment.apps -n kube-systemIf the operator installed successfully, you’ll see clickhouse-operator in the output: NAME READY UP-TO-DATE AVAILABLE AGE clickhouse-operator 1/1 1 1 80s coredns 1/1 1 1 102dMore Information The following section provides more information on the resources created in the installation. Altinity Kubernetes Operator Resources Details Customization optionsTo customize Altinity Kubernetes Operator settings see: Operator GuideAltinity recommends that you install a specific version of the ClickHouse-operator version that you know will work with your Kubernetes environment, rather than use the latest build from the GitHub master branch. For details on installing other versions of the Altinity Kubernetes Operator see: Specific Version Installation Guide Deleting a deploymentThis section covers how to delete a deployment. IMPORTANT NOTICENever delete the operator or run the following command while there are live ClickHouse clusters managed by the operator. The command will hang due to the live clusters. If you then re-install the operator, those clusters will be deleted and the operator will not work correctly. To delete the operator, use this command with the URL you used when you installd it: kubectl delete -f https://github.com/Altinity/clickhouse-operator/raw/0.21.2/deploy/operator/clickhouse-operator-install-bundle.yamlIf you used a customized version of the operator’s YAML file, use that filename instead: kubectl delete -f clickhouse-operator-install-bundle.yamlMore information Deleting the operator while clusters are running can cause them to be deleted without warningTo delete a deployment using the latest clickhouse-operator YAML file: kubectl delete -f https://raw.githubusercontent.com/Altinity/clickhouse-operator/master/deploy/operator/clickhouse-operator-install-bundle.yamlTo delete a deployment using your local clickhouse-operator YAML file: kubectl delete -f clickhouse-operator-install-bundle.yaml |
CopyRight 2018-2019 实验室设备网 版权所有 |